Skip to content

docs: add CIP-48 lower block time to 3 seconds#390

Merged
rootulp merged 2 commits intocelestiaorg:mainfrom
rootulp:worktree-sparkling-hugging-manatee
Mar 1, 2026
Merged

docs: add CIP-48 lower block time to 3 seconds#390
rootulp merged 2 commits intocelestiaorg:mainfrom
rootulp:worktree-sparkling-hugging-manatee

Conversation

@rootulp
Copy link
Collaborator

@rootulp rootulp commented Mar 1, 2026

Summary

  • Adds CIP-48 proposing to reduce the Celestia block time from 6 seconds to 3 seconds
  • Documents parameter changes: TimeoutPropose, DelayedPrecommitTimeout, MaxAgeNumBlocks, upgrade height delays, IBC MaxExpectedTimePerBlock, and GoalBlockTime removal
  • Adds CIP-48 to SUMMARY.md

Closes celestiaorg/celestia-app#6622

Test plan

  • Review CIP content for accuracy
  • Verify parameter values match celestia-app implementation (#6643, #6661)

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request introduces a significant improvement to the Celestia network by proposing to halve the block time. This change is designed to enhance the user experience through faster transaction confirmations and increase the network's data throughput capacity. It involves a series of carefully calculated parameter adjustments across consensus, evidence, and IBC modules to ensure network stability and maintain existing time-based guarantees despite the accelerated block production.

Highlights

  • Block Time Reduction: The Celestia block time is proposed to be reduced from 6 seconds to 3 seconds, aiming to improve transaction confirmation latency and overall network throughput.
  • Consensus Parameter Adjustments: Key consensus timeout parameters, specifically TimeoutPropose and DelayedPrecommitTimeout, have been adjusted to align with the new 3-second block time.
  • Block-Count Parameter Doubling: Parameters based on block counts, such as MaxAgeNumBlocks and various upgrade height delays (Arabica, Mocha, Mainnet), have been doubled to maintain their original wall-clock durations at the faster block rate.
  • IBC Parameter Correction: The IBC MaxExpectedTimePerBlock parameter has been corrected from 75 seconds to 15 seconds to accurately reflect the new expected block time, adhering to IBC documentation guidelines.
  • Deprecation of GoalBlockTime: The GoalBlockTime constant, which was inaccurate and misleading, has been deprecated and removed, as the actual block time is governed by consensus timeout parameters.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog
  • cips/SUMMARY.md
    • Added a new entry for CIP-48 to the list of Celestia Improvement Proposals.
  • cips/cip-048.md
    • Introduced a new CIP document detailing the proposal to reduce Celestia's block time to 3 seconds.
    • Outlined specific parameter changes for consensus timeouts, evidence, upgrade delays, and IBC.
    • Provided motivation, specification, rationale, and security considerations for the block time reduction.
Activity
  • A new Celestia Improvement Proposal (CIP-48) has been added.
  • The PR description includes a test plan for reviewing CIP content and verifying parameter values against celestia-app implementation PRs (#6643, #6661).
  • The PR was generated with Claude Code.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@rootulp rootulp self-assigned this Mar 1, 2026
Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces CIP-48, which proposes to reduce the Celestia block time from 6 to 3 seconds. The changes include adding the new CIP-48 document and updating the summary file to include it. The CIP document is well-structured and details the necessary parameter changes and their rationale. I've identified a couple of minor issues in the document: a typo in the creation date and a misleading explanation in the security considerations regarding the evidence validity window. I've provided suggestions to correct these.

…TimePerBlock governance

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@rootulp rootulp marked this pull request as ready for review March 1, 2026 06:14
@rootulp rootulp merged commit 372280d into celestiaorg:main Mar 1, 2026
4 of 5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Write 32MB / 3 second CIP

2 participants